HSS Peer Service Configuration Mode Commands

HSS Peer Service Configuration Mode Commands
 
 
The HSS Peer Service Configuration Mode is used to create and manage the HSS Peer Service.
 
 
auth-request
Configures the number of authentication vectors the MME requests in an Authentication-Information-Request (AIR) message to the HSS for each UE requiring authentication.
Product
MME
Privilege
Administrator
Syntax
auth-request num-auth-vectors num
default auth-request num-auth-vectors
num-auth-vectors num
Specifies the number of vectors the MME is requesting from the HSS. Default = 1. num must be an integer value from 1 to 3.
Usage
Use this command to configure the number of authentication vectors the MME requests in an Authentication-Information-Request (AIR) message to the HSS for each UE requiring authentication.
Receiving multiple vectors from the HSS for a given UE helps reduce the number of messages across the diameter connection plus provides the MME with additional vectors for the UE in the event that the connection or the HSS id disabled.
To view the current number of requested vectors, execute the show hss-peer-service service name <name> command in the Exec mode.
Example
The following command sets the number of requested vectors to 2:
auth-request num-auth-vectors 2
 
diameter hss-dictionary
Specifies the Diameter Credit Control dictionary for the HSS peer service.
Product
MME
Privilege
Administrator
Syntax
diameter hss-dictionary { custom1 | standard | standard-r9 } [ eir-dictionary { custom1 | standard | standard-r9 } ]
default diameter hss-dictionary
default
Sets the dictionary to default for HSS service.
custom1
Default: Disabled
This keyword sets the Diameter dictionary to a customer-specific HSS Diameter dictionary.
standard
Default: Disabled
This keyword sets the Diameter dictionary to the standard HSS peer dictionary.
standard-r9
Default: Enabled
This keyword sets the Diameter dictionary to the standard HSS peer dictionary for release 9.
eir-dictionary { custom1 | standard }
Specifies that an Equipment Identity Register (EIR) dictionary is to be used in conjunction with the HSS Diameter dictionary.
custom1: This keyword sets the EIR Diameter dictionary to a customer-specific EIR Diameter dictionary.
standard: This keyword sets the EIR Diameter dictionary to the standard HSS peer dictionary.
standard-r9: This keyword sets the EIR Diameter dictionary to the standard HSS peer dictionary for release 9.
Usage
Use this command to select the Diameter dictionary for the HSS peer service.
Example
The following command sets the Diameter dictionary to IETF RFC 4006 specific:
diameter hss-dictionary standard
 
diameter hss-endpoint
This commands associates a preconfigured Diameter origin endpoint with this HSS peer service.
Product
MME
Privilege
Administrator
Syntax
diameter hss-endpoint endpoint_name [ eir-endpoint eir_endpoint_name ]
no diameter hss-endpoint
no
Removes previously associated Diameter origin endpoint from this HSS peer service.
endpoint_name
Identifies a preconfigured Diameter endpoint specific to the HSS interface. The endpoint must be present in all Diameter messages and is the endpoint that originates the diameter message.
endpoint_name must be an preconfigured Diameter endpoint name and be from 1 to 63 alpha and/or numeric characters.
eir-endpoint eir_endpoint_name
Identifies a preconfigured Diameter endpoint specific to the S13 Equipment Identity Register (EIR) interface. eir_endpoint_name must be an existing Diameter endpoint and be from 1 to 63 alpha and/or numeric characters.
Usage
Use this command to associated a Diameter origin endpoint to create a Diameter-based S6a interface association in this HSS peer service to provide AAA functionality to the EPS bearer context.
Optionally, use this command to associate a Diameter origin endpoint to create a Diameter-based S13 interface association in this HSS peer service to provide IMEI query capability between the MME and an EIR.
Refer to the Diameter Endpoint Configuration Mode Commands chapter for more information on Diameter endpoint configuration parameters.
Example
The following command associates the preconfigured Diameter endpoint hss_1 with this HSS peer service for HSS interface support.
diameter hss-endpoint hss_1
 
end
Exits the current mode and returns to the Exec Mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
end
Usage
Change the mode back to the Exec mode.
 
exit
Exits the current mode and returns to the previous mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
exit
Usage
Return to the previous mode.
 
failure-handling
This command configures the failure handling behavior in the event of a failure with the HSS peer service. It also defines the action on various error codes on Diameter interface during authentication or session activities.
Product
MME
Privilege
Security Administrator, Administrator
Syntax
failure-handling { authentication-information-request | check-identity-request | notify-request | purge-ue-request | update-location-request } { diameter-result-code start_error_code [ to end_error_code ] | request-timeout } action { continue | retry-and-terminate | terminate }
no failure-handling { authentication-information-request | check-identity-request | notify-request | purge-ue-request | update-location-request } diameter-result-code start_error_code [ to end_error_code ]
default failure-handling { authentication-information-request | check-identity-request | notify-request | purge-ue-request | update-location-request } request-timeout
no
Removes the preconfigured failure handling procedures for calls in an HSS peer service.
default
Sets the default action for failure handling procedure for calls in an HSS peerservice.
For default actions on Diameter result/error codes see Usage section of this section.
authentication-information-request
This keyword configures the MME-HSS service to handle the failures in Auth-Information-Request message.
check-identity-request
This keyword configures the MME-HSS service to handle the failures in Check-Identity-Information-Request message.
notify-request
This keyword configures the MME-HSS service to handle the failures in Notify-Request message.
purge-ue-request
This keyword configures the MME-HSS service to handle the failures in Purge-UE-Request message.
update-location-request
This keyword configures the HSS peer service to handle the failures in Update-Location-Request message.
diameter-result-code start_error_code [to end_error_code]
This keyword configures the HSS peer service to handle the failures for various request message having specific single or range of Diameter result code in request message.
start_error_code specifies the individual error code on Diameter protocol and must be an integer from 3000 through 5999. This will be the starting of code if a range of error codes is specified with optional keyword to end_error_code.
to end_error_code is used to specify a range of error codes to handle by this command. end_error_code specifies the end error code on Diameter protocol and must be an integer from 3000 through 5999.
request-timeout
This keyword configures the HSS peer service to handle the failures for various request messages if response to that message is not received before timeout duration exhausted.
action { continue | retry-and-terminate | terminate }
This keyword specifies the action to be taken on failure of any message as policy of failure handling.
•
continue: On receipt of any error, this action configuration will allow the HSS peer service to continue with the session procedure without any interruption.
•
retry-and-terminate: On receipt of any error, this action configuration will instruct the HSS peer service to retry with the procedure. Sustem will retry up to the configured number of attempts and terminate the session/procedure if it received subsequent number of errors after retry attemps.
•
terminate: This action configuration will allow the HSS peer service to terminate the session procedure without any retry attemp on the event of any failure.
Usage
Use this command to configure the failure handling behavior in the event of a communication failure with the HSS peer service.
Following are the default action for Diameter result codes:
•
For all protocol error codes 3000 to 3999 the default action is terminate. For all transient error codes 4000, 4001, 4004 to 4180, and 4182 to 4999 the default action is continue.
•
For transient error codes 4002, 4003, and 4181 the default action is retry.
•
For error code 4001 the default action is terminate.
•
For permanent error codes 5000 to 5999 the default action is terminate
Example
The following command will allow HSS peer service to continue if any failure in Auth-Information-Request message occurred with Diameter error code 3050:
failure-handling authentication-information-request diameter-result-code 3050 action continue
 
request timeout
This command configures the application request timeout between HSS peer service and HSS node. The MME system will wait for this duration before retransmitting the request to corresponding HSS node.
Product
MME
Privilege
Administrator
Syntax
request timeout dur
[ no | default ] request timeout
no
Disables the configured application request timeout value.
default
Sets the application request time out duration to default value of 300 seconds.
dur
Default: 300 seconds
Specifies the application request timeout duration in seconds. The MME will wait for this duration before retrying the request with corresponding HSS.
dur must be an integer from 1 through 300.
Usage
Use this command to set the waiting period for HSS peer service in seconds after which the request is deemed to have failed or system will resend the request.
Example
The following example configures the application request timeout duration to 300 seconds:
default request timeout
 
 
Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883